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ABSTRACT 

This  document  describes  the  features,  user  procedures,  and  program/ 
coding  specifications  for  the  BR-90  Assembly  Program  (BRASS)  which  is 
operational  on  an  IBM  1410  computer. 
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SECTIOIJ  I 


BACKGROUND 


BRASS,  a  BR-90  assembly  program,  was  designed  for  use  at  the 
AFICCS  Support  Facility  specifically  to  provide  a  vehicle  for 
experimental  program  development  under  the  Display  Console  Technology 
Task.  Outstanding  features  of  tne  assembler  are  the  following: 

1)  tape  (not  disk)  oriented;  2)  AFICCS  independent;  and  3)  opera¬ 
tional  on  third-generation  computer  systems  (emulation)  . 

During  the  BRASS  implementation  phase,  the  standard  BR-90  Normal 
Mode  Control  Program  (N-mode)  was  used  as  part  of  the  test  package 
and  the  following  highlights  were  noted:  1)  N-mode  consists  of  4000 
source  statements  with  800  user- labels;  and  2)  BRASS  assembled  N-mode 
in  12  minutes  using  1/5  of  the  allowable  user-label  area  for  N-mode 
labels . 
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SECTION  II 


USER  PROCEDURES 


2.0  INTRODUCTION 

BRASS,  the  BR-90  (AN/FYQ-45)  Assembly  Program,  is  an  IBM  1410 
program  which  assembles  BR-90  source  statements  into  BR-90  executable 
code.  Input  is  fixed  format,  one  card  per  source  statement;  output 
is  to  cards,  each  card  containing  a  maximum  of  34  BR-90  words  (in 
BCD  format) .  The  assembly  is  a  two-pass  operation  using  tape  as 
intermediate  storage . 

2.1  INPUT  CARD  FORMATS 


A  BRASS  input  deck  is  defined  as  a  TITLE  card  followed  by  one 
or  more  instruction  and/or  comment  cards  terminated  by  an  END  card. 


2.1.1  TITLE  CARD 


The  TITLE  card, 
has  the  following  format- 


Columns  1-6. 

7-11: 
29- 78: 


the  mandatory  first  card  in  the  deck, 

program  identity 

TITLE 

remarks 


where  program  identity  is  an  optional  1  through 
6  character  identification. 


Program  identity  and  remarks  will  be  printed  in  the  header  line  of 
each  page  of  the  assembly  listing.  In  addition,  the  program  identity 
will  be  punched  in  columns  75  through  80  of  each  object  card. 

2.1.2  INSTRUCTION  CARD 


Each  instruction 

card  has  the  following  format 

Columns  1-6: 

label 

7-10: 

operation  code 

11-12: 

address  option 

14-28: 

operand/operand  address 

29-80: 

comments 

2.1.3  LABEL 

A  label  consists  from  1  to  6  characters  le ft- just  if ied 
in  the  label  field.  At  least  one  character  of  the  label  must  be 
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non- numeric  and  the  label  must  not  be  defined  more  than  once.  Note 
that  plus  signs,  minus  signs,  or  commas  should  not  be  used  in  labels 
since  these  symbols  are  used  within  an  expression  as  delimiters. 

Note  also  that  an  asterisk  (*)  should  be  avoided  as  the  first  label 
character  since  it  would  indicate  a  comment  card. 

2.1.4  OPERATION  CODE 

An  operation  code  must  be  one  of  the  16  machine  codes 
or  one  of  the  12  psuedo-operations  defined  in  Appendix  A.  The  entry 
must  be  left- justified. 

2.1.5  ADDRESS  OPTION 

For  machine  codes,  an  address  option  must  be  one  of  the 
9  options  listed  in  Appendix  A.  For  psuedo-operations,  the  address 
option  field  must  be  blank. 

2.1.6  OPERAND /OPERAND  ADDRESS 

The  operand/operand  address  may  be  one  of  the  following: 
blank; 

an  octal  number; 
a  decimal  number; 
a  label;  or 

an  expression,  a  combination  of  labels  and/or 
decimal  numbers. 

The  entry  must  be  left- justified. 

2.1.7  COMMENTS 

This  field  is  ignored  by  the  assembler  but  is  carried 
on  the  assembly  listing. 

2 . 2  COMMENT  CARD 

Each  comment  card  has  the  following  format: 

Column  1:  * 

Columns  2-80:  remarks 

The  comment  card  is  ignored  by  the  assembly  processor,  but  is 
carried  on  the  assembly  listing. 
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2.3  END  CARD 


The  END  card  has  the  following  format* 
columns  7-9:  END 

columns  14-28:  location  of  first  executable  instruction. 

Columns  14-28  may  be  blank  or  may  contain  a  decimal  number,  a 
label,  or  an  expression.  A  non-blank  entry  must  be  left- justified. 

If  this  field  is  blank,  the  location  of  the  first  executable 
instruction  will  be  assumed  to  be  the  lower  limit  of  BR-90  user  core 
defined  as  0062g. 

2,4  OBJECT  DATA  CARD 

The  Object  Data  Card  has  the  following  format 


columns 

1-4: 

octal  location  of  the  first  BR-90  word 
punched  in  the  card. 

columns 

5-6: 

decimal  number  of  BR-90  words  punched 
in  this  card  (01  <  COUNT  <34) . 

columns 

7-74: 

consecutive  BR-90  words  where  a  BR-90  word 
is  represented  by  two  BCD  characters. 

columns 

75-80: 

program  identity. 

Object  Data  cards  are  filled  with  sequential  BR-90  word 
representations.  Any  break  in  the  sequential  flow  of  the  BR-90 
source  program  will  cause  a  new  object  data  card  to  be  generated. 
Thus,  the  object  data  cards  are  independent  of  one  another,  and  the 
order  of  the  object  deck  is  net  significant. 

2.3  OBJECT  END  CARD 

The  Object  End  card  has  the  following  format: 
columns  1-3:  END. 

columns  4-7:  octal  location  of  the  first  executable 
instruction  of  the  BR-90  program, 
columns  75-80:  program  identity 

2.6  ASSEMBLER  ERROR  INDICATORS 

A  source  statement  may  generate  one  or  more  assembly  errors. 
These  error  conditions  are  noted  by  character  error  flag  codes 
carried  on  the  assembly  listing  to  the  right  of  the  source  statement 
image.  These  error  flags  and  their  associated  meanings  are  as 
follows: 
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Error  Flag 


Meaning 


U 


Illegal  label  field 


M 


Multiple-defined  label 


A 


Illegal  operation  and/or  address 
option  field 


0 


Illegal  operand /operand  address 
field 


L 


Location  counter  overflow  (>-7777„) 
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Error  types  U,  M,  A,  and  0  will  cause  a  BR-90  "all  aeroa"  word 
to  be  generated.  Error  type  L  is  only  a  warning  indication  noting 
that  overflow  has  occurred  and  that  the  location  counter  was  reset  to 
0062g  at  the  first  instance  of  overflow. 

2. 7  OPERATING  PROCEDURES 

BRASS)  a  non-AFICCS  dependent  program,  may  be  called  by  one  of 
two  methods: 

a)  by  COPS  within  AFIGCS ,  if  SAP  assembled  the  BRASS 
AUTOCODER  source  statements;  or 

b)  by  an  object  deck  loader,  if  PR108  assembled  the 
BRASS  AUTOCODER  source  statements. 

BRASS  non-AFICCS  hardware  requirements  are  as  follows: 

a)  minimum  of  20K  1410  core; 

b)  one  tape  drive; 

c)  card  reader /punch; 

d)  console  typewriter;  and 

e)  printer. 

To  assemble  BR-90  source  programs  using  BRASS: 

a)  mount  a  blank  tape  on  channel  1,  drive  2; 
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b)  ready  card  punch; 

c)  if  in  AFICCS,  load  BR-90  source  program  deck(s)  in 
reader  and  call  BRASS  via  console  typewriter. 

If  non-AFICCS ,  load  object  deck  loader,  BRASS  object 
deck,  and  BR-90  source  program  deck(s)  in  reader, 
and  bootstrap  the  loader. 

d)  enter  date  of  BR-90  assembly  after  typewriter  cue 
message ; 

e)  upon  completion  of  the  assembly  process,  AFICCS  may 
be  reloaded  by  placing  the  AFICCS  system  tape  on 
channel  1,  drive  1  and  pressing  COMPUTER  RESET  and 
START . 

BRASS  accepts  batch  assemblies.  If  no  END  card  is  used,  the 
assembler  generates  an  object  end  card  and  a  dummy  "end  card1' 
printer  line  with  the  MAn  flag  set. 
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APPENDIX  A 
LEGAL  VALUES 

OPERATIONS 

The  following  are  the  Legal  operations  and  their  associated 
meanings . 


MNEMONIC 

OPERATION 

BU 

Branch  unconditional 

ST 

Store  X-register 

XF 

External  function 

10 

Input /output 

BV 

Branch  on  overflow 

LD 

Load  X-register 

DS 

Display 

XM 

Extract  to  memory 

BL 

Branch  link 

EX 

Extract  to  X 

AD 

Add  to  X 

SU 

Subtract  from  X 

BZ 

Branch  on  X  equal  to  zero 

MG 

Merge  to  X 

SH 

Shift  X  right 

MM 

Merge  to  memory 
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ADDRESS  OPTIONS 


OPERATIONS 

For  legal  operations,  with  the  exception  of  the  SH 
operation,  the  following  are  the  legal  address  options  and  their 
associated  meanings. 


ADDRESS  OPTION 

DESCRIPTION 

DS 

Direct  from  scratchpad 

IS 

Indirect  from  scratchpad 

DM 

Direct  from  memory 

IM 

Indirect  from  memory 

DR 

Direct  relative 

IR 

Indirect  relative 

For  the  SH  operation,  the  following  are  the  legal  address 
options  and  their  associate  meanings. 


ADDRESS  OPTION 

DESCRIPTION 

OL 

Open  logical  right  shift 

CL 

Closed  logical  right  shift 

ON 

Open  numeric  right  shift 

OPERAND /OPERAND  ADDRESS 

For  legal  operations,  with  the  exception  of  the  SH  operation, 
the  operand/operand  address  must  be  either  blank  or  an  EXPRESSION 
depending  upon  the  address  option  selected. 

For  address  options  DM  or  IM,  the  operand/operand  address  must 
be  blank. 

For  address  options  DS  or  IS,  the  operand /operand  address  must 
be  an  EXPRESSION  whose  octal  value  is  in  the  range  0  through  77. 

For  address  options  DR  or  IR,  the  operand/operand  address  must 
be  an  EXPRESSION  whose  value  is  within  77g  positions  of  the  location 
of  the  instruction;  that  is,  the  value  [EXPRESSION  — 1  -  location  of 
the  instruction]  must  be  between  0  through  77g.  This  value  is  a 
relative  address  modifier  and  is  placed  in  the  actual  machine 
instruction. 


For  the  SH  operation,  the  operand /operand  address  must  be  an 
unsigned  decimal  number  whose  range  is  1  through  15. 

An  EXPRESSION  is  defined  qs  a  combination  of  labels  and  decimal 
numbers.  If  S  means  label  and  I  means  a  decimal  number,  the  follow¬ 
ing  are  legal  EXPRESSIONS. 

I 

+1 

S 

±S 

1+6 

S+I 

+I+S 

+S+I 

+S+S 

+1+1 

PSEUDO  OPERATIONS 

The  following  are  the  legal  pseudo  operations  and  their 
associated  meanings.  Appendix  B  contains  more  detail  on  the  pseudo 
operations . 


MNEMORIC 

PSEUDO  OPERATION 

ORG 

Origin 

RES 

Reserve 

PZE 

Plus  Zero 

Blank  Field 

Same  as  PZE 

OCT 

Octal 

EQU 

Equals 

EQUB 

Equals  octal 

VCO 

Vector  coordinates 

SCO 

Symbol  coordinates 

CIR 

Circle 

BCIC 

Binary  coded  information 
console 

PAGE 

Page  eject 
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PREDEFINED  LABELS 


The  assembler  defines  a  number  of  labels  prior  to  any  assembly. 
These  labels  may  be  used  by  any  source  BR-90  program.  The  user 
should  be  aware  of  what  labels  are  predefined  since  the  error  M  will 
be  set  if  a  user  attempts  to  define  a  predefined  label  in  his 
program.  The  following  are  the  predefined  labels  and  their  associated 
octal  values. 


LABEL 


OCTAL  VALUE 


* 

Current  value  of  tl 

0 

$E0M 

37 

$ST0P 

0 

$ START 

1 

$P1 

2 

$P2 

3 

$P3 

4 

$P4 

5 

$P5 

6 

$P6 

7 

$11 

10 

$12 

11 

$13 

12 

H 

13 

$15 

14 

$16 

15 

$17 

16 

$18 

17 
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LABEL 

OCTAL  VALUE 

$NIA 

20 

$LG 

21 

$LH 

22 

$T1 

23 

$T2 

24 

$T3 

25 

$T4 

26 

$T5 

27 

$T6 

30 

$T7 

31 

$T8 

32 

$T9 

33 

$T10 

34 

$T11 

35 

$T12 

36 

$T13 

37 

$T14 

40 

$T15 

41 

$T16 

42 

$T17 

43 

$T18 

44 

$T19 

45 

$T20 

46 

$T21 

47 

$T22 

50 

$T23 

51 

$X24 

52 

$T25 

53 

$T26 

54 

$T27 

55 
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LABEL 

OCTAL 

$T28 

56 

$T29 

57 

$T30 

60 

$T31 

61 

$T32 

62 

$T33 

63 

$T34 

64 

$T35 

65 

$T36 

66 

$T37 

67 

$T38 

70 

$T39 

71 

$T40 

72 

$MTWO 

73 

$MONE 

74 

$TWO 

75 

$ONE 

76 

$ZERO 

77 

$POW 

100 

$INA 

104 

$INB 

110 

$DIS 

114 
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APPENDIX  B 


PSEUDO  OPERATIONS 

ORIGIN  -  (ORG) 

The  ORG  pseudo  op  causes  the  location  counter  to  be  set  to  the 
value  given  in  the  operand/operand  address  field*  The  operand/operand 
address  field  must  contain  an  expression  whose  value  is  in  the  range 
Og  to  7777s-  Labels,  if  used  in  the  expression,  must  be  previously 
defined.  ORG  may  not  be  a  labelled  statement. 

RESERVE  -  (RES) 

The  RES  pseudo  op  causes  the  assembler  to  reserve  one  or  more 
consecutive  BR-90  words  within  the  object  program  commencing  with 
the  current  value  of  the  location  counter.  The  operand /operand 
address  field  must  contain  an  unsigned  decimal  number  within  the 
range  1  to  4095.  RES  may  be  labelled,  in  which  case,  the  label 
refers  to  the  first  word  of  the  block.  A  reserve  statement  resulting 
in  a  location  counter  overflow  is  considered  illegal. 

PLUS  ZERO  -  (PZE) 

The  PZE  pseudo  op  causes  the  assembler  to  reserve  one  BR-90 
word  whose  value  is  equal  to  the  octal  value  of  the  expression  in 
the  operand /operand  address  field.  A  symbol  appearing  in  the 
expression  need  not  be  defined  prior  to  the  PZE  statement.  A  blank 
operation  field  is  equivalent  to  the  PZE  pseudo  op.  PZE  may  be  a 
labelled  statement . 

OCTAL  -  (OCT) 

The  OCT  pseudo  op  causes  the  assembler  to  reserve  one  BR-90 
word  whose  value  is  equivalent  to  the  signed  or  unsigned  octal 
number  in  the  operand/operand  address  field.  The  octal  number  must 
be  between  — 7777g  and  +7777^.  OCT  may  be  a  labelled  statement. 

EQUALS  -  (EQU) 

The  EQUALS  pseudo  op  causes  the  label  in  the  label  field  to 
be  equated  to  the  octal  value  of  the  expression  in  the  operand /operand 
address  field.  A  symbol  appearing  in  the  expression  must  be  defined 
prior  to  the  EQU  statement.  EQU  must  be  a  labelled  statement. 
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VECTOR  COORDINATES  -  (VCO) 


The  VCO  pseudo  op  causes  the  assembler  to  generate  two  BR-90 
words  containing  the  x,y  coordinates  as  defined  by  the  EXPRESSIONS 
in  the  operand/operand  address  field.  The  operand/operand  address 
field  may  be  one  of  two  formats. 

a)  EXPRESSION,  EXPRESSION; 

b)  EXPRESSION,  EXPRESSION,  COMBINATION  where  COMBINATION  may 
be  the  letters  U,  B>  W,  E  in  any  order.  These  letter  codes 
mean  the  following* 

U  =  generate  vector; 

B  *=  blimc  vector; 

W  =  wide  vector ; 

E  =  end  of  string. 

A  label  in  an  EXPRESSION  need  not  be  defined  prior  to  the  VCO 
pseudo  op.  VCO  may  be  a  labelled  statement. 

SYMBOL  COORDINATES  ~  (SCO) 

The  SCO  pseudo  op  causes  the  assembler  to  generate  two  BR-90 
words  containing  the  x,y  coordinates  as  defined  by  the  EXPRESSIONS 
in  the  operand/operand  address  field.  The  format  of  the  operand/ 
operand  address  field  is  EXPRESSION;,  EXPRESSION.  A  Label  in  an 
EXPRESSION  need  not  be  defined  prior  to  the  SCO  pseudo  op.  SCO  may 
be  a  labelled  statement. 

CIRCLE  -  (CIR) 

The  CIR  pseudo  op  causes  the  assembler  to  generate  one  BR-90 
word  containing  information  necessary  to  generate  a  :le.  The 
operand/operand  address  field  may  be  one  of  two  formats. 

a)  EXPRESSION, 

b)  EXPRESSION ,  COMBINATION 

where  COMBINATION  may  be  the  letters  W,  B,  N  in  any 
order.  The  meaning  of  these  letter  codes  is  as 
f o 1 lows : 
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W  -  wide  circle, 


B  =  blink  circle, 

N  -  blank  display. 

A  label  in  the  EXPRESSION  need  not  be  defined  prior  to  the  CIR 
pseudo  op.  GIF  may  be  a  labelled  statement. 

BINARY  CODED  INFORMATION  CONSOLE  -  (BCIC) 

The  BCIC  pseudo  cp  causes  the  assembler  to  generate  a  number 
of  BR-90  words  containing  the  character  representations  defined  in 
the  operand/cperand  address  field.  The  operand/operand  address  field 
may  have  one  of  three  formats* 

a)  XX...  X$ 

1-1A  characters 

b)  XX... X 

15  characters 

c)  XX. . .  .X$ COMBINATION 

where  $  is  the  string  terminator  and  COMBINATION 
may  be  the  letters  E,  B,  L,  M,  N  in  any  order. 

The  meanings  of  the  letter  codes  are  as  follows: 

E  -  end  of  string, 

B  -  blink  symbol  , 

L  =  large  symbol; 

M  =  generate  marker; 

N  =  bLank  symbol. 

BCIC  may  be  a  labelled  statement,  and  if  labelled,  the  label 
refers  to  the  first  BR-90  word  generated. 

PAGE  EJECT  -  (PAGE) 

The  PAGE  pseudo  op  directs  the  assembler  to  generate  no  BR-90 
words,  b  t  causes  the  printing  portion  of  the  assembler  to  start  a 
new  printed  page.  The  PAGE  pseudo  op  will  be  printed  as  the  first 
line  of  the  new  page. 
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EQUALS  OCTAL  -  (EQUB) 


The  EQUALS  OCTAL  pseudo  op  causes  the  label  in  the  label  field 

to  be  equated  to  the  octal  value  of  the  signed  or  unsigned  octal 

number  in  the  operand/operand  address  field.  The  octal  number  must 

be  between  —7777,,  to  +  7777,,.  The  EQUB  must  be  a  labelled  statement 
o  o  ' 


16 


APPENDIX  C 


IL 

&' 

Ct 

Ll 


CL 

o 

o 

c 

z 

< 


PQ 


17 


APPENDIX  C  (Continued) 


* 

* 


> 

3 


co 

co 

< 

co 

CO 

< 

a 

CD 


CL 

X 

< 


Q 

Of 


o 

ac 


o  o  o 

OC  OC  QC 

<  <  < 

u  u  o 


3 


o 

Of 


z 

o 


O  Q  O 

5  5  5 

U  o  o 

3  3  3 

Z  Z  2 

3  3  3 

z  z  X 

I  ail  I 

W  ®  U  O. 


u 

ID 

Z 

CL. 

3 

O 

1 

UJ 

OC 

a 


a 

ac 

< 

o 


z 

UJ 

X 


p  o  a  a  a 

ac  oc  a  oc  a 

3  «  <  <  < 

u  u  o  o  u 


z  Z 

UJ  ID 

z  X 

S  5 

o  v> 


X  X 

X  X 

o  o 

o  o 


vu 


a 

II 


< 

oc 


a 

Q 


< 

z 

5 

QC 

O 

o 

o 


o 

OC  UJ 
<  -J 

o  o 

CO 

*-  z 

*  p 

UJ  o 

is 

o  ~ 


X 

oc 

c 

CL 

z 


Q 

OC 

o 

o 

o 


a 

c 

o 


-j  O  co 

UJ  LJ  CO 

OQ  Z  X  UJ 

<  O  O' 

3  ►-i/IQ 

I-I^O 

C  -J  <  cu  < 

uj  jj  oc  ac 

z  CD  UJ  Q  C 

>-<UO\ 
IL  J  O  <  D 


Z 

o 


co  Z 
(3 

X  ~ 

a  3 

-j  < 

U.  O 

cr  u 

UJ  —I 

> 

Q  3 


z  < 

tj 

—  o 

►-  z 


OC  3 

u 


cu 

z 

31 

3 

X 

> 

OC 

3 

3 

> 

1 

< 

< 

< 

< 

3 

3 

OC 

3 

a: 

* 

3 

c 

c 

3 

OC 

►— 

O 

o 

o 

O 

3 

3 

CO 

< 

< 

o 

CO 

3 

3 

3 

z 

< 

3 

CD 

O 

< 

3 

3 

3 

3 

3 

< 

Of 

t— • 

3 

3 

3 

CO 

CO 

i A 

< 

3 

O 

X 

OC 

z 

3 

3 

3 

3 

3 

O 

< 

X 

O 

a 

oc 

3 

z 

> 

UJ 

3 

o 

3 

3 

*— 

M 

Q 

3 

3 

3 

3 

3 

3 

3 

UJ 

UJ 

o 

Cl 

co 

oc 

CD 

o 

> 

CO 

3 

CD 

X 

3 

co 

UJ 

► 

3 

(M 

O 

<M 

3 

CD 

4- 

V— 

4fc 

CD 

3 

r—t 

♦ 

3 

< 

3 

+ 

3 

♦ 

3 

• 

3 

UJ 

OC 

3 

P— 

p— 

o 

o 

3 

a 

3 

p 

eel 

o 

3 

< 

Ifl 

3 

♦ 

2 

3 

o 

o 

O' 

CD 

in 

c 

3 

o 

< 

3 

3 

fl4 

2? 

3 

* 

o 

3 

—4 

4k 

CO 

o 

CM 

O' 

< 

O' 

3 

z 

o 

K 

U> 

o 

i/> 

♦ 

o 

3 

o 

4k 

in 

3 

O 

m 

♦ 

o 

3 

o 

CO 

"• 

♦ 

♦ 

O 

* 

«# 

%* 

♦ 

3 

o 

1 

o 

in 

p- 

co 

O 

O 

O 

♦ 

* 

— * 

< 

>3* 

Ct 

X 

x 

CO 

OC 

OC 

< 

OC 

UJ 

o 

C 

o 

a 

o 

o 

-J 

£ 

3  3 

OC 

3 

3 

3 

5 

o 

UJ 

o 

CD 

CO 

3 

o 

C 

OC 

— «  c 

of 

3 

3 

3 

3 

3  O 

3 

O  3 

Q 

a 

a 

o 

QC 

3J 

0C  3 

31 

3 

3 

3 

O 

3 

o 

•— • 

3  < 

3 

3 

3 

O 

3 

3 

3 

3 

Of 

3 

Of 

3 

Z 

3 

CL 

UJ 

UJ 

c 

a 

O  CO 

a. 

CO 

OC 

O 

> 

CO 

3 

cd  a 

0. 

a 

a 

CO 

a 

co 

c 

u 

CL 

Q  a 

3 

-1 

-i 

3 

UJ 

UJ 

hr 

3 

3 

CD 

CD 

3 

3 

«C 

CO 

< 

3 

Z 

< 

UJ 

-J 

3 

U 

i— i 

3 

O' 

3 

— •  < 

O' 

18 


APPENDIX  C  (Continued) 
BRASS _ Assembly  Listing 
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TEST  1  THIS  IS  AN  EXAMPLE  OF  A  BRASS  ASSEMBLY  26  FEB  68  PAGE  002 
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SECTION  III 

PROGRAM/CODING  SPECIFICATIONS 


3.0  .PROGRAM  DESCRIPTION 

The  BRASS  assembler  was  designed  for  use  in  the  1410  AFICCS 
system  or  on  a  1410  computer  which  has  no  AFICCS  system  and  has  the 
following  minimum  hardware  requirements: 

20K  core  memory; 

card  reader/punch; 

one  channel,  1  tape  drive; 

printer;  and 

console  typewriter. 

To  enable  BRASS  to  maintain  this  duality,  the  following  programming 
conventions  were  used: 

a)  origin  at  500; 

b)  no  pre- defined  group  mark  -  word  marks;  and 

c)  all  I/O  references  imbedded  within  the  program. 

Because  of  these  conventions,  BRASS  1410  Autocoder  source  code 
may  be  assembled  by  either  the  SAP  assembler  or  by  the  PR108  assembler. 
If  assembled  by  SAP  within  AFICCS,  BRASS  will  integrate  on  disk  and 
will  be  assigned  the  COPS  calling  name  BRASS.  If  assembled  by  PR108, 
a  1410  object  deck  will  be  punched  which  may  be  loaded  into  a  1410 
computer  by  a  standard  bootstrap  loader. 

BRASS  is  a  two-pass  assembler.  The  first  pass  reads,  partially 
assembles,  and  saves  the  BR-90  source  code  on  tape.  The  second  pass 
reads  the  stored  instructions  from  tape  and  completes  the  assembly, 
prints  the  assembly  listing  and  punches  the  BR-90  object  card  deck. 
BRASS  has  within  it  predefined  system  labels  which  may  be  used  by  any 
BR-90  source  program. 
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BRASS's  core  map  is  as  follows: 


0 


500 


13000 


15000 


u 


Lower  core  (0-499)  is  initialised  immediately  upon  execution  of 
the  BRASS  code.  The  user  label  table  is  built  up  from  about  15000 
and  remains  in  core  throughout  the  entire  assembly  process.  Thus  the 
limiting  factor  to  the  number  of  labels  is  the  amount  of  core  (up 
to  40K)  . 
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3.1  ROUTINE  DESCRIPTION 


TITLE- 

BR-90  Assembly  Program  (BRASS) 

CLASS: 

Program 

SIZE: 

15,000  characters 

ORIGIN: 

500 

DATE: 

27  February  1968 

FUNCTION 

This  program  assembles  BR-90  source  code 
statements  into  executable  BR-90  octal 
machine  codes. 

CALLING  SEQUENCE: 

Within  AFICCS ,  type  in  BRASS.  Otherwise, 
load  BRASS  1410/PR108  object  deck  with  1410 
object  deck  loader. 

INPUT: 

BR-90  source  deck(s) 

OUTPUT: 

Assembly  listing(s)  and  BR-90  object  deck(s) 

NORMAL  RETURN. 

At  normal  exit,  BRASS  types  out  cue  message 
and  halts.  At  such  time,  AFICCS  may  be 
reloaded  by  mounting  the  AFICCS  system  tape 
on  channeL  1,  drive  1  and  pressing  COMPUTER 
RESET  and  START. 

ERROR  RETURN: 

Program  halts  on  unrecoverable  errors. 

ERROR  PRINTOUTS: 

Subroutines  TAPECOMMON,  READRPUNCH,  and 

PRINTERR  type  out  indicative  hardware 
errors. 

n  SYMBOL  TABLE  FULL  -  DUMP  40K  CORE"  “if 
assembly  labels  fill  core  from  15000  to  40000. 

SUBROUTINES: 

TAPECOMMON  and  READRPUNCH  are  explained  in 
PCS-AF-l,  Volume  2,  Part  2.  All  other 
significant  subroutines  of  BRASS  are  flow¬ 
charted  in  the  following  sections. 

ACCESSED  SDA's: 

None. 

REMARKS: 

BRASS  is  programmed  using  1410  Autocoder 
such  that  it  could  be  assembled  by  either 

SAP  or  PR108.  BRASS,  therefore,  is  independent 
of  AFICCS  and  may  be  used  at  a  1410  facility 
which  has  no  AFICCS  system. 

3.2  FLOW  CHARTS 


The  following  flow  chart®  describe  th*  program  flow  of  the 
BRASS  Assembly  Program. 
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